home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / dev / misc / GuiGFXLib.readme < prev    next >
Text File  |  1999-07-01  |  8KB  |  210 lines
  1. Short:    Application layer for pixel graphics
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (Timm.Mueller@darmstadt.netsurf.de)
  4. Version:  16.0
  5. Type:     dev/misc
  6. Requires: Kickstart 3.0 (v39), MC68020, render.library v30
  7.  
  8.  
  9. overview
  10. -----------------------------
  11.  
  12.   - guigfx.library is an application layer for pixel graphics.
  13.  
  14.   - guigfx.library breaks the chains of all those nasty
  15.     planar, chunky, 8/16/24bit, OS3.0, OS3.1, OCS, ECS, AGA,
  16.     CybergraphX and Picasso96 considerations.
  17.  
  18.   - with guigfx.library you no longer have to take care about your
  19.     application running on a OCS machine or on a high-end
  20.     graphics-card system.
  21.  
  22.   - guigfx.library lets you freely choose truecolor graphics for
  23.     your applications.
  24.  
  25.   - with guigfx.library your graphics will always look as fine as
  26.     possible, on any screen, no matter if driven on 24 bit
  27.     1024x768 CybergraphX/Picasso96, on HAM8, or 1 bit productivity
  28.     interlaced.
  29.  
  30.   - guigfx.library does quick color-reduction, rendering,
  31.     remapping and dithering for you. only you don't know when,
  32.     on which machine, under what circumstances.
  33.  
  34.   - guigfx.library treats scaling as a standard operation.
  35.     it is available at any time, without extra consideration,
  36.     without extra memory consumption, even without a true loss
  37.     of performance.
  38.     
  39.   - guigfx.library handles screen pen allocation in an extremely
  40.     effective way.
  41.  
  42.   - guigfx.library hides bugs, incompatibilities and insufficiencies
  43.     of graphics.library, cybergraphics.library and Picasso96 from
  44.     you. it is an attempt to render incompatibilities between
  45.     different versions of CybergraphX and Picasso96 obsolete.
  46.     
  47.   - guigfx.library features picture.datatype import. standard and
  48.     v43 (including Picasso96) picture datatypes are automatically
  49.     recognized and used as available.
  50.  
  51.   - guigfx.library does not call SetFunction() and is hereby
  52.     guaranteed to never do so in future versions.
  53.  
  54.   - guigfx.library puts all that stuff into a black-box,
  55.     freeing your mind for the creative part.
  56.  
  57.  
  58. features
  59. -----------------------------
  60.  
  61.   - full truecolor, OCS, ECS, AGA, HAM support
  62.   - screen-pen management
  63.   - color-reduction
  64.   - dithering
  65.   - picture.class datatype import
  66.   - scaling
  67.   - image processing methods 
  68.     (crop, scale, render, tint, 
  69.     alpha-channel, texture-mapping, ...)
  70.   - fully documented
  71.   - supplied with C includes for SAS/C, StormC and MaxonC
  72.   - freeware
  73.  
  74.  
  75. requirements
  76. -----------------------------
  77.  
  78.   - render.library v30 (dev/misc/renderlib.lha)
  79.   - MC68020
  80.   - OS3.0 (v39)
  81.   
  82.   optional:
  83.   higher OS, higher CPU, FPU,
  84.   CyberGraphX or Picasso 96
  85.  
  86.  
  87. recent changes
  88. -----------------------------
  89.  
  90. v16
  91.  
  92.     - added GGFX_RastLock for passing an optional SignalSemaphore
  93.       that may be used for locking a drawhandle's rastport while
  94.       rendering.
  95.  
  96.     - default dithermode is now DITHERMODE_EDD.
  97.  
  98.     - v39 exec pooled memory environment reactivated (it was
  99.       disabled since v10).
  100.  
  101.     - added StormC includes.
  102.  
  103.     - removed all assembler and E includes. I'm too lazy to
  104.       keep the assembler files up-to-date manually, and the
  105.       iconvert tool of E throws enforcer-hits on my system.
  106.       (if you're programming the respective languages, you
  107.       should have better ways to transform the includes than
  108.       I have)
  109.  
  110.  
  111. v15.2
  112.  
  113.     - static-palette drawhandles allocate much better pens now
  114.       (a YUV colorspace is used instead of RGB), and allocation
  115.       is quicker.
  116.  
  117.  
  118. ============================= Archive contents =============================
  119.  
  120. Original  Packed Ratio    Date     Time    Name
  121. -------- ------- ----- --------- --------  -------------
  122.      441     186 57.8% 04-Jun-99 03:15:46 +doc.info
  123.      324     175 45.9% 04-Jun-99 03:15:46 +author.info
  124.      441     182 58.7% 04-Jun-99 03:15:46 +autodoc.info
  125.      324     175 45.9% 04-Jun-99 03:15:46 +examples.info
  126.    17659    6767 61.6% 24-May-99 02:06:10 +history
  127.      324     173 46.6% 04-Jun-99 03:15:46 +history.info
  128.     2181     865 60.3% 13-Jul-98 13:05:44 +legal
  129.      324     177 45.3% 04-Jun-99 03:15:46 +legal.info
  130.     1712     763 55.4% 21-Jul-98 08:01:08 +prefs
  131.      324     177 45.3% 04-Jun-99 03:15:46 +prefs.info
  132.      441     185 58.0% 24-May-99 02:17:02 +examples.info
  133.      450     200 55.5% 24-May-99 02:17:02 +fd.info
  134.      450     200 55.5% 24-May-99 02:17:02 +include.info
  135.      450     198 56.0% 24-May-99 02:17:02 +libs.info
  136.      441     186 57.8% 24-May-99 02:17:02 +maxonc.info
  137.      441     188 57.3% 24-May-99 02:17:02 +Prefs.info
  138.     3435    1616 52.9% 04-Jun-99 03:14:22 +README
  139.      324     173 46.6% 24-May-99 02:17:02 +README.info
  140.      547     309 43.5% 04-Jun-99 03:16:24 +author
  141.    92215   16936 81.6% 24-May-99 01:56:30 +guigfx
  142.    78284   15314 80.4% 24-May-99 01:54:50 +guigfx.doc
  143.      324     177 45.3% 04-Jun-99 03:15:32 +guigfx.doc.info
  144.      335     229 31.6% 04-Jun-99 03:15:32 +guigfx.info
  145.     3893    1264 67.5% 14-Feb-99 00:21:40 +examples
  146.      441     178 59.6% 13-Jul-98 12:35:24 +MystiCube.info
  147.    35352   21483 39.2% 13-Jul-98 12:34:10 +MystiCube
  148.     1166     530 54.5% 13-Jul-98 12:24:00 +MystiCube.doc
  149.      324     169 47.8% 13-Jul-98 12:35:24 +MystiCube.doc.info
  150.      441     184 58.2% 13-Jul-98 12:37:32 +Plasma.info
  151.      441     183 58.5% 13-Jul-98 12:38:12 +ShadeBobs.info
  152.      847     532 37.1% 13-Jul-98 12:35:24 +MystiCube.info
  153.      441     186 57.8% 13-Jul-98 12:35:24 +source.info
  154.    16448    9779 40.5% 26-Oct-97 19:49:32 +Mystic_Logo.o
  155.    11825   11825  0.0% 26-Oct-97 19:48:08 +MysticLogo.gif
  156.    28482    7133 74.9% 13-Jul-98 12:19:52 +MystiCube.c
  157.     5505    1853 66.3% 08-Jul-98 20:38:34 +mysticube.h
  158.      240     179 25.4% 13-Jul-98 12:33:42 +SCOPTIONS
  159.     2157     704 67.3% 12-Aug-97 17:19:02 +timer.asm
  160.       90      74 17.7% 08-Aug-97 21:37:08 +timer.h
  161.      816     463 43.2% 08-Aug-97 22:02:02 +timer.o
  162.    17664   10619 39.8% 13-Jul-98 12:33:16 +plasma
  163.     1206     546 54.7% 13-Jul-98 12:48:08 +Plasma.doc
  164.      324     177 45.3% 13-Jul-98 12:37:32 +Plasma.doc.info
  165.      358     243 32.1% 13-Jul-98 12:37:32 +Plasma.info
  166.      441     183 58.5% 13-Jul-98 12:37:32 +source.info
  167.      947     368 61.1% 01-Jan-98 01:58:50 +misc.h
  168.    13752    3973 71.1% 15-Dec-97 21:35:52 +plasma.c
  169.      129     107 17.0% 13-Jul-98 12:33:14 +plasma.lnk
  170.      198     154 22.2% 13-Jul-98 12:33:02 +SCOPTIONS
  171.     2157     704 67.3% 12-Aug-97 17:19:02 +timer.asm
  172.       90      74 17.7% 08-Aug-97 21:37:08 +timer.h
  173.      816     463 43.2% 08-Aug-97 22:02:02 +timer.o
  174.    18472   10641 42.3% 13-Jul-98 12:40:18 +ShadeBobs
  175.     1243     561 54.8% 13-Jul-98 12:48:06 +ShadeBobs.doc
  176.      324     175 45.9% 13-Jul-98 12:38:12 +ShadeBobs.doc.info
  177.      358     243 32.1% 13-Jul-98 12:38:12 +ShadeBobs.info
  178.      441     185 58.0% 13-Jul-98 12:38:12 +source.info
  179.      947     368 61.1% 01-Jan-98 01:58:50 +misc.h
  180.      198     154 22.2% 13-Jul-98 12:33:02 +SCOPTIONS
  181.    15156    4012 73.5% 05-Dec-97 22:52:06 +ShadeBobs.c
  182.     2157     704 67.3% 12-Aug-97 17:19:02 +timer.asm
  183.       90      74 17.7% 08-Aug-97 21:37:08 +timer.h
  184.      816     463 43.2% 08-Aug-97 22:02:02 +timer.o
  185.     1245     483 61.2% 01-Jan-98 00:30:46 +guigfx_lib.fd
  186.     3166     765 75.8% 23-May-99 21:36:26 +guigfx_protos.h
  187.     3251    1036 68.1% 17-May-99 22:51:14 +guigfx.h
  188.     2427     543 77.6% 26-Jul-98 18:25:42 +guigfx_pragmas.h
  189.      180     128 28.8% 06-Jan-98 09:17:00 +guigfx.h
  190.    44928   24387 45.7% 02-Jun-99 20:29:02 +guigfx.library
  191.    42556   22985 45.9% 02-Jun-99 20:42:42 +guigfx.library_68040
  192.    42564   23016 45.9% 02-Jun-99 20:47:08 +guigfx.library_68060
  193.    42532   22990 45.9% 02-Jun-99 20:35:40 +guigfx.library_FPU
  194.      441     180 59.1% 06-Jan-98 09:17:00 +c-libs.info
  195.     5254     853 83.7% 19-May-99 22:45:00 +guigfx.lib
  196.      888     457 48.5% 24-May-99 01:59:36 +maxon.readme
  197.      324     182 43.8% 06-Jan-98 09:17:00 +maxon.readme.info
  198.      441     183 58.5% 06-Jan-98 09:17:00 +pragma.info
  199.     1792     466 73.9% 19-May-99 22:45:00 +guigfx_lib.h
  200.        3       3  0.0% 06-Jan-98 09:17:00 +AUTODITHERTHRESHOLD
  201.      441     187 57.5% 04-Jun-99 03:15:22  GuiGFXLib.info
  202.        1       1  0.0% 29-Jun-98 05:52:12 +USESCALEPIXELARRAY
  203.        1       1  0.0% 06-Jan-98 09:17:00 +USEWPA8
  204.      441     178 59.6% 24-May-99 02:17:08 +stormc.info
  205.     2938     580 80.2% 19-May-99 22:49:44 +guigfx_lib.h
  206.     2303     868 62.3% 19-May-99 22:46:52 +disk_pragmas.h.info
  207.      134     126  5.9% 19-May-99 23:20:04 +guigfx_pragmas.h
  208. -------- ------- ----- --------- --------
  209.   587635  238059 59.4% 06-Jun-99 22:20:06   86 files
  210.